

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>RTF Bookmarks [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, RTF Report,RTF Report Bookmarks,Bookmark,Bookmark Package As,Bookmark For RTF Report,Package,Package As RTF Bookmark,Insert,Insert Bookmarked RTF Into Word">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">RTF Bookmarks</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="o1055.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="o890.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_BodyText"><span class="f_BodyText">Bookmarks are markers that are automatically placed in your rich text document when you generate it. You can create a master document in Word and link to sections of an Enterprise Architect report based on bookmarks. For example, a Word document might have a section for a small part of your component model. Using bookmarks you can generate a full component model, and then link into just one section of the report.</span></p>
<p class="p_BodyText"><span class="f_BodyText">This way you can maintain a complex Word document from parts of Enterprise Architect reports. If you link into Enterprise Architect reports, then you can regenerate the report and refresh Word links to update the master document without having manually changed anything. For more information on refreshing links, see the </span><span class="f_BodyText" style="font-style: italic;"><a href="refreshlinks.htm">Refresh Links</a></span><span class="f_BodyText"> topic.</span></p>
<p class="p_BodyText"><span class="f_BodyText">Bookmarks are GUID-based numbers that can be created for packages, diagrams and elements. A package bookmark applies from the beginning of a package to the end, and includes all child packages and elements underneath.</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="952" bgcolor="#efeff7" style="width:952px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="952" bgcolor="#f7f7ff" style="width:952px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">You cannot use RTF Bookmarking in </span><span class="f_TiporNoteText"><a href="create_master_document.htm">Master Document</a> </span><span class="f_TiporNoteText">elements, which effectively replace RTF Bookmarking in Word.</span><br>
<span class="f_TiporNoteText">&nbsp;</span><br>
<span class="f_TiporNoteText">RTF Bookmarking requires each bookmark to be unique. When you generate a report with a standard RTF template (including in a single Model Document element), each bookmark is unique and there is a 1:1 association between the </span><span class="f_TiporNoteText">Elements-details</span><span class="f_TiporNoteText"> being generated and the elements in the repository. As Master Documents are intended to contain multiple sub-documents, the association ceases to be 1:1. There is no simple method that enables the generated data to be uniquely identified directly in association with the original element.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Bookmark a Section of Enterprise Architect for RTF Documentation</span></p>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=1><span class="f_NumberedList">In the Enterprise Architect </span><span class="f_UIControl">Project Browser</span><span class="f_NumberedList">, right-click on the package to include in the documentation. The context menu displays.</span></li>
<li value=2><span class="f_NumberedList">Select the </span><span class="f_MenuKeyField">Documentation | Copy RTF Bookmark</span><span class="f_NumberedList"> menu option to paste the package into the clipboard as a bookmark for use in Word.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="clipboardbookmark.png" width="269" height="303" border="0" alt="ClipboardBookmark"><br>
<span class="f_NumberedList">&nbsp;</span></li>
</ol>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Insert a Bookmarked Section of an Enterprise Architect RTF Document into Word</span></p>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=1><span class="f_NumberedList">Open the Word document and position the cursor at the point at which to insert the file.</span></li>
<li value=2><span class="f_NumberedList">Select the Word </span><span class="f_MenuKeyField">Insert | File</span><span class="f_NumberedList"> menu option. The </span><span class="f_UIControl">Insert</span><span class="f_NumberedList"> dialog displays.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="insertfiledialog.png" width="592" height="359" border="0" alt="InsertFileDialog"><br>
<span class="f_NumberedList">&nbsp;</span></li>
<li value=3><span class="f_NumberedList">Locate and click on the file to insert, then click on the </span><span class="f_MenuKeyField">Range</span><span class="f_NumberedList"> button.</span></li>
<li value=4><span class="f_NumberedList">In the </span><span class="f_MenuKeyField">Range</span><span class="f_NumberedList"> cell type or paste the information from the clipboard.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="setrange.png" width="289" height="117" border="0" alt="SetRange"><br>
<span class="f_NumberedList">&nbsp;</span></li>
<li value=5><span class="f_NumberedList">Click on the </span><span class="f_MenuKeyField">OK</span><span class="f_NumberedList"> button</span><span class="f_NumberedList">.</span></li>
<li value=6><span class="f_NumberedList">Click on the drop-down arrow next to the </span><span class="f_MenuKeyField">Insert</span><span class="f_NumberedList"> button. Select the </span><span class="f_MenuKeyField">Insert as Link</span><span class="f_NumberedList"> option.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="mswordinsert.png" width="126" height="77" border="0" alt="mswordinsert"><br>
<span class="f_NumberedList">&nbsp;</span></li>
</ol>
<p class="p_BodyText"><span class="f_BodyText">The </span><span class="f_MenuKeyField">Insert</span><span class="f_BodyText"> option sets a permanent copy; the </span><span class="f_MenuKeyField">Insert as Link</span><span class="f_BodyText"> option creates a link that is updateable on altering the source document. For </span><span class="f_MenuKeyField">Insert as Link</span><span class="f_BodyText"> to operate you must first set <a href="refreshlinks.htm">Refresh Links</a>.</span></p>
<p class="p_BodyText"><span class="f_BodyText">Every package is bookmarked in the RTF document according to the following rules:</span></p>
<ul style="text-indent: 0px; margin-left: 30px; list-style-position: outside;">
<li><span class="f_Bulletlist1">All alphabetic and numeric characters remain the same</span></li>
<li><span class="f_Bulletlist1">All other characters (including spaces) are converted to underscores.</span></li>
</ul>
<p class="p_BodyText"><span class="f_BodyText">For example </span><span class="f_BodyText" style="font-style: italic;">UC01: Use Case Model</span><span class="f_BodyText"> becomes </span><span class="f_BodyText" style="font-style: italic;">UC01__Use_Case_Model</span><span class="f_BodyText">.</span></p>




            </div>
          </div>
        </div>



</div>


</body>
</html>
